.. highlightlang:: us

.. index:: @f{latex}

.. _@f{latex}:

@f{latex}
=========

.. us.tag  @f{latex} GERMAN fieldfunction

Zeigt eine mit LaTeX formatierte Formel in einem Textobjekt oder einer
Tabellenzelle an.

.. function::  @f{latex(LatexFormula)}
               @f{latex(LatexFormula, DisplayParameter)}
               @f{latex(LatexAliasName)}
               @f{latex(LatexAliasName, DisplayParameter)}

.. us.params

**Parameter**

.. us.params

.. uparam:: LatexFormula

   Die Formel kann direkt eingeben werden. Die Formel muss
   in eine Zeile geschrieben werden und mit doppelten $-Zeichen beginnen
   und enden (display math mode). Beispiel:

   .. code-block:: none

      @f{latex($$\dot{m}$$)}

   Anstatt die Formel direkt einzugeben, kann die Formel auch in einer 
   Datei gespeichert werden, siehe :ref:`tools-latex-configuration`. Die Formel
   kann dann auch mehrzeilig sein, und wird über ihren Namen ausgewählt.

.. uparam:: LatexAliasName

   Ist der Name einer LaTeX-Formel, die mit dem 
   Kommando :ref:`tools-latex-configuration` definiert werden kann. Beispiel:

   .. code-block:: none

      @f{latex(m_dot)}

.. uparam:: DisplayParameter

   Die LaTeX-Formel wird als PNG-Bild angezeigt. Die Größe des Bildes kann
   mit den folgenden Parametern festgelegt werden. Der Defaultwert ist
   height = 1em. Die Einheit ``em`` ist die Schriftgröße der ausgewählten 
   Schriftart. Sie können auch 1.5em eingeben.

   Darstellungsparameter:

   .. list-table::
      :header-rows: 1

      * - Parameter
        - Abkürzung
        - Bedeutung
      * - name
        - n
        - Name des Bildes. Damit das Bild angezeigt werden kann, muss es unter
          gleichem Namen in der Anhangliste vorhanden sein.
      * - width
        - w
        - Breite des Bildes.
      * - height
        - h
        - Höhe des Bildes.
      * - xoffset 
        - x
        - Horizontale Verschiebung
      * - yoffset
        - y
        - Vertikale Verschiebung
      * - keepratio
        - k
        - Wenn keepratio = 1 ist, wird das Höhe-Breite Verhältnis beibehalten. Bei
          keepratio = 0 kann das Bild verzerrt werden. keepratio = 1 ist der
          Defaultwert.

   Einheiten für Höhe, Breite und Verschiebung:

   .. list-table::
      :header-rows: 1

      * - Einheit
        - Beschreibung
      * - em
        - Einheit ist eine Zeilenhöhe. Die Zeilenhöhe hängt von der ausgewählten
          Schriftgröße ab.
      * - cm
        - Einheit ist Zentimeter.
      * - mm
        - Einheit ist Millimeter.
      * - in
        - Einheit ist Inch.
      * - pc
        - Einheit ist Pica (1/6 inch).
      * - pt
        - Einheit ist Point (1/72 inch).
      * - %
        - Prozent der Originalgröße (0 bis 1000%).

.. us.comment

**Kommentar**

Für das erstellen von neuen LaTeX-Formeln muss LaTeX auf Ihrem 
Rechner installiert sein. Infos zur Installation finden Sie unter
:ref:`edit-insert-formula`.

Für jede Formel wird eine PNG-Bild-Datei mit Hilfe des Kommandos
:ref:`tools-latex-configuration` erzeugt. Der Name der Formel
wird an die Feldfunktion übergeben.

.. us.example

**Beispiel**

Mit dem Kommando :ref:`tools-latex-configuration` wird die folgende
Zeile in die Latex-Konfiguration eingetragen:

.. code-block:: none

   q_dot = $$\dot{q}$$

Der Name der Formel wird dann als erster Parameter an die Feldfunktion
übergeben:

.. code-block:: none

   @f{latex(q_dot)}

**Ausgabe**:

.. math::

   \dot{q}

**Beispiel**

Mit dem Kommando :ref:`tools-latex-configuration` wird die folgende
Zeile in die Latex-Konfiguration eingetragen::

.. code-block:: none

   formel1 = $$\int_{0}^{\infty} x^2 e^{-x^2} dx = \frac{\sqrt{\pi}}{4}$$

Der Name der Formel wird dann als erster Parameter an die Feldfunktion
übergeben:

.. code-block:: none

   @f{latex(formel1, h=2em)}

**Ausgabe**:

.. math::

   \int_{0}^{\infty} x^2 e^{-x^2} dx = \frac{\sqrt{\pi}}{4}

**Beispiel**

Die Latex-Formel kann auch direkt als erster Paramter an die Feldfunkion
übergeben werden:

.. code-block:: none

   @f{latex($$\dot{m}$$, h=1em)}

**Ausgabe**:

.. math::

   \dot{m}

.. seealso::
   :ref:`tools-latex-configuration`,
   :ref:`edit-insert-formula`,
   :ref:`diagraminsert-field-function`
   :ref:`uberblick-feldfunktionen`,
   :ref:`bearbeitenfelder-aktualisieren`,
   :ref:`diagrammfeldfunktion-einfugen`,
   :ref:`dateialias-tabelle-bearbeiten`

:sub:`id-1870472`